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Introduction 

The Apache web server is the most popular way of serving web content on the internet. 

It accounts for more than half of all active websites on the internet and is extremely 
powerful and flexible. 

Apache breaks its functionality and components into individual units that can be 
customized and configured independently. The basic unit that describes an individual 
site or domain is called a virtual host. 

These designations allow the administrator to use one server to host multiple domains 
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or sites off of a single interface or IP by using a matching mechanism. This is relevant to 
anyone looking to host more than one site off of a single VPS. 

Each domain that is configured will direct the visitor to a specific directory holding that 
site's information, never indicating that the same server is also responsible for other 
sites. This scheme is expandable without any software limit as long as your server can 
handle the load. 

In this guide, we will walk you through how to set up Apache virtual hosts on an Ubuntu 
14.04 VPS. During this process, you'll learn how to serve different content to different 
visitors depending on which domains they are requesting. 

Prerequisites 

Before you begin this tutorial, you should create a non-root user as described in steps 
1-4 here. 

You will also need to have Apache installed in order to work through these steps. If you 
haven't already done so, you can get Apache installed on your server through apt - 
get : 

sudo apt-get update 

sudo apt-get install apache2 


After these steps are complete, we can get started. 

For the purposes of this guide, my configuration will make a virtual host for 
example . com and another for test . com . These will be referenced throughout the 
guide, but you should substitute your own domains or values while following along. 

To learn how to set up your domain names with DigitalOcean, follow this link. If you do 
not have domains available to play with, you can use dummy values. 

We will show how to edit your local hosts file later on to test the configuration if you are 
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using dummy values. This will allow you to test your configuration from your home 
computer, even though your content won't be available through the domain name to 
other visitors. 

Step One — Create the Directory Structure 

The first step that we are going to take is to make a directory structure that will hold the 
site data that we will be serving to visitors. 

Our document root (the top-level directory that Apache looks at to find content to 
serve) will be set to individual directories under the /va r/www directory. We will create 
a directory here for both of the virtual hosts we plan on making. 

Within each of these directories, we will create a public html folder that will hold our 
actual files. This gives us some flexibility in our hosting. 

For instance, for our sites, we're going to make our directories like this: 

sudo mkdir -p /var/www/example . com/publichtml 
sudo mkdir -p /var/www/test . com/publichtml 


The portions in red represent the domain names that we are wanting to serve from our 
VPS. 

Step Two — Grant Permissions 

Now we have the directory structure for our files, but they are owned by our root user. If 
we want our regular user to be able to modify files in our web directories, we can 
change the ownership by doing this: 

sudo chown -R $USER:$USER /va r/www/example . com/publichtml 
sudo chown -R $USER:$USER /va r/www/test . com/publichtml 
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The $USER variable will take the value of the user you are currently logged in as when 
you press "ENTER". By doing this, our regular user now owns the publichtml 
subdirectories where we will be storing our content. 

We should also modify our permissions a little bit to ensure that read access is 
permitted to the general web directory and all of the files and folders it contains so that 
pages can be served correctly: 

sudo chmod -R 755 /var/www 


Your web server should now have the permissions it needs to serve content, and your 
user should be able to create content within the necessary folders. 

Step Three — Create Demo Pages for Each 
Virtual Host 

We have our directory structure in place. Let's create some content to serve. 

We're just going for a demonstration, so our pages will be very simple. We're just going 
to make an index.html page for each site. 

Let's start with example . com . We can open up an index . html file in our editor by 
typing: 

nano /va r/www/example . com/public_html/index . html 


In this file, create a simple HTML document that indicates the site it is connected to. My 
file looks like this: 


<html> 

<head> 

<title>Welcome to Example. com! </title> 
</head> 


https://www.digitalocean.com/community/tutorials/how-to-set-up-apache-virtual-hosts-on-ubuntu-14-04-lts 


4/20 


2/17/2016 


How To Set Up Apache Virtual Hosts on Ubuntu 14.04 LTS | DigitalOcean 


<body> 

<hl>Success! The example.com virtual host is working !</hl> 
</body> 

</html> 


Save and close the file when you are finished. 

We can copy this file to use as the basis for our second site by typing: 


cp /va r/www/example . com/public_html/index . html /va r/www/test . com/public_htm 


We can then open the file and modify the relevant pieces of information: 


nano /var/www/test . com/public_html/index. html 


<html> 

<head> 

<title>Welcome to Test. com !</title> 

</head> 

<body> 

<hl>Success! The test.com virtual host is working !</hl> 
</body> 

</html> 


Save and close this file as well. You now have the pages necessary to test the virtual 
host configuration. 

Step Four — Create New Virtual Host Files 

Virtual host files are the files that specify the actual configuration of our virtual hosts 
and dictate how the Apache web server will respond to various domain requests. 


Apache comes with a default virtual host file called 000 -default . conf that we can 
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use as a jumping off point. We are going to copy it over to create a virtual host file for 
each of our domains. 

We will start with one domain, configure it, copy it for our second domain, and then 
make the few further adjustments needed. The default Ubuntu configuration requires 
that each virtual host file end in . conf . 

Create the First Virtual Host File 

Start by copying the file for the first domain: 

sudo cp /etc/apache2/sites-available/000-default . conf /etc/apache2/sites-av 


Open the new file in your editor with root privileges: 


sudo nano /etc/apache2/sites-available/example. com. conf 


The file will look something like this (I've removed the comments here to make the file 
more approachable): 


cVirtualHost *:80> 

ServerAdmin webmaster@local.host 
DocumentRoot /var/www/html 
ErrorLog ${APACHE_LOG_DIR}/error . log 
CustomLog ${APACHE_LOG_DIR}/access . log combined 
</VirtualHost> 


As you can see, there's not much here. We will customize the items here for our first 
domain and add some additional directives. This virtual host section matches any 
requests that are made on port 80, the default HTTP port. 

First, we need to change the Se rve rAdmin directive to an email that the site 
administrator can receive emails through. 
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ServerAdmin admin@example. com 


After this, we need to odd two directives. The first, called Serve rName , establishes the 
base domain that should match for this virtual host definition. This will most likely be 
your domain. The second, called Serve rAlias , defines further names that should 
match as if they were the base name. This is useful for matching hosts you defined, like 
www : 

ServerName example.com 
ServerAlias www.example.com 


The only other thing we need to change for a basic virtual host file is the location of the 
document root for this domain. We already created the directory we need, so we just 
need to alter the Document Root directive to reflect the directory we created: 


DocumentRoot /var/www/example . com/public_html 


In total, our virtualhost file should look like this: 


cVirtualHost *:80> 

ServerAdmin admintaexample.com 
ServerName example.com 
ServerAlias www.example.com 
DocumentRoot /var/www/example. com/public_html 
E r ro rLog ${APACHE_LOG_DIR}/e r ro r . log 
CustomLog ${APACHE_LOG_DIR}/access . log combined 
</VirtualHost> 


Save and close the file. 


Copy First Virtual Host and Customize for Second Domain 

Now that we have our first virtual host file established, we can create our second one 


https://www.digitalocean.com/community/tutorials/how-to-set-up-apache-virtual-hosts-on-ubuntu-14-04-lts 


7/20 


2/17/2016 


How To Set Up Apache Virtual Hosts on Ubuntu 14.04 LTS | DigitalOcean 


by copying that file and adjusting it as needed. 
Start by copying it: 


sudo cp /etc/apache2/sites-available/example.com.conf /etc/apache2/sites-av 


Open the new file with root privileges in your editor: 


sudo nano /etc/apache2/sites-available/test . com. conf 


You now need to modify all of the pieces of information to reference your second 
domain. When you are finished, it may look something like this: 


cVirtualHost *:80> 

ServerAdmin admin@test.com 
ServerName test.com 
ServerAlias www.test.com 
DocumentRoot /var/www/test . com/public_html 
E r ro rLog ${APACHE_LOG_DIR}/e r ro r . log 
CustomLog ${APACHE_LOG_DIR}/access . log combined 
</VirtualHost> 


Save and close the file when you are finished. 

Step Five — Enable the New Virtual Host Files 

Now that we have created our virtual host files, we must enable them. Apache includes 
some tools that allow us to do this. 

We can use the a2ensite tool to enable each of our sites like this: 

sudo a2ensite example. com. conf 
sudo a2ensite test . com . conf 


https://www.digitalocean.com/community/tutorials/how-to-set-up-apache-virtual-hosts-on-ubuntu-14-04-lts 


8/20 


2/17/2016 How To Set Up Apache Virtual Hosts on Ubuntu 14.04 LTS | DigitalOcean 

When you are finished, you need to restart Apache to make these changes take effect: 

sudo service apache2 restart 


You will most likely receive a message saying something similar to: 

* Restarting web server apache2 

AH00558 : apache2: Could not reliably determine the server's fully qualifie 

< U I ► 


This is a harmless message that does not affect our site. 

Step Six — Set Up Local Hosts File (Optional) 

If you haven't been using actual domain names that you own to test this procedure and 
have been using some example domains instead, you can at least test the functionality 
of this process by temporarily modifying the hosts file on your local computer. 

This will intercept any requests for the domains that you configured and point them to 
your VPS server, just as the DNS system would do if you were using registered 
domains. This will only work from your computer though, and is simply useful for testing 
purposes. 

Make sure you are operating on your local computer for these steps and not your VPS 
server. You will need to know the computer's administrative password or otherwise be 
a member of the administrative group. 

If you are on a Mac or Linux computer, edit your local file with administrative privileges 
by typing: 

sudo nano /etc/hosts 
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If you are on a Windows machine, you can find instructions on altering your hosts file 
here. 

The details that you need to add are the public IP address of your VPS server followed 
by the domain you want to use to reach that VPS. 

For the domains that I used in this guide, assuming that my VPS IP address is 
111 . Ill . Ill .111,1 could add the following lines to the bottom of my hosts file: 

127.0. 0.1 localhost 

127.0. 1.1 guest-desktop 

111.111.111.111 example.com 
111.111.111.111 test.com 


This will direct any requests for example.com and test.com on our computer and 
send them to our server at 111 . Ill . Ill . Ill . This is what we want if we are not 
actually the owners of these domains in order to test our virtual hosts. 

Save and close the file. 

Step Seven — Test your Results 

Now that you have your virtual hosts configured, you can test your setup easily by 
going to the domains that you configured in your web browser: 

http://example.com 


You should see a page that looks like this: 

Success! The example.com virtual host is working! 

Likewise, if you can visit your second page: 
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http://test.com 


You will see the file you created for your second site: 

Success! The test.com virtual host is working! 

If both of these sites work well, you've successfully configured two virtual hosts on the 
same server. 

If you adjusted your home computer's hosts file, you may want to delete the lines you 
added now that you verified that your configuration works. This will prevent your hosts 
file from being filled with entries that are not actually necessary. 

If you need to access this long term, consider purchasing a domain name for each site 
you need and setting it up to point to your VPS server. 

Conclusion 

If you followed along, you should now have a single server handling two separate 
domain names. You can expand this process by following the steps we outlined above 
to make additional virtual hosts. 

There is no software limit on the number of domain names Apache can handle, so feel 
free to make as many as your server is capable of handling. 
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Leave a comment... 


Log In to Comment 


michaelleblancl April 24, 2014 

Got stuck at the "Create the First Virtual Host File" step: my droplet has a file called 
"default" and "default-ssl" in sites-available, not "default.conf" as stated. And is the 
subsequent statement: "The default Ubuntu configuration requires that each virtual host file 
end in .conf." still correct? 

0 ? 


joshlsullivan February 28, 2015 
Look for 000-default.conf 

asb April 24, 2014 

@michaelleblanc1: It sounds like you are on a different Ubuntu release, perhaps 12.04. This 
tutorial is specifically talking about 14.04 where the file has been renamed from simply 
"default" to "000-default.conf" Assuming that you are on 12.04, you should be fine, but you 
might also want to take a look at this article: 

https://www.digitalocean.com/community/articles/how-to-set-up-apache-virtual-hosts-on- 

ubuntu-12-04-lts 


kerem April 28, 2014 

Thanks for this great tutorial. My primary virtual host (ie example.com) is alive and well. 

My droplet's ip address still points to /var/www/html though and provides the "Apache2 
Ubuntu Default Page". I would like my ip to point to the new virtual host I created and 
hence to /var/www/test.com/public_html. How can I achieve this result? 
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Thank you. 

0 ? 


joshlsullivan February 28, 2015 

You have to "sudo cp /etc/apache2/sites-available/000-default.conf /etc/a pache2/sites- 
available/example.com.conf". The conf file tells the server where to direct traffic. Reread "Step 
Four — Create New Virtual Host Files". Let me know if I can help further. 

<2 


ftthv August 24, 2015 

you have disable the 000-default.conf 

sudo a2dissite 000-default.conf ^ 

asb April 28, 2014 

@Kerem: Do you still have the default configuration enabled? If so, edit the file 
7etc/apache2/sites-enabled/000-default.conf" and change "DocumentRoot /var/www/html" 
to "DocumentRoot /var/www/test.com/public_html" 




MorgariJohnstone December 17, 2014 

Hi, I've set up two virtual hosts like the article details and I'm having a similar issue to @kerem I 
want to be able to host two websites on the server, but in the /sites-enabled/OOO-default.conf 
there is only space for one (1) document root. How do I add in /var/www/doc/publichfm/ and 
/ var/www/morgan/publichXm \ ? I've done (and triple checked) the settings and files in this article, 
and I'm not sure what I'm missing. 

<2 


jellingwood December 17, 2014 
@MorganJohnstone: Hello! 

To serve two websites with Apache, you'll have to create a virtual host for each. The main 
sections that deals with this is Steps 4 and 5. 

You'll want a virtual host file (a file that contains the configuration for a site between 
<VirtualHost *:80> and </VirtualHost> tags) for each of your sites. In one of them, 
you can have the document root pointed at /va r/www/doc/public_html , and in the other, 
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you can have the document root pointed at /va r/www/mo rgan/publichtml . 

The Serve rName and Serve rAlias directives in each of these virtual hosts will determine 
which content will be served by matching the values against the client's request. 

When you've finished creating a file for each of your sites, you need to enable them with the 
a2ensite command (this is covered in step 5). Afterwards, be sure to restart Apache. 

If you're still having issues after following these steps, post back with exactly what is happening. 
Hope this helps! 

Oi 

kerem April 29, 2014 

@Andrew SB, Thank you very much. This worked perfectly. 

0 ? 


almeralmazan May 1, 2014 

Thank you very much.. Your guide help me a lot. =) 

0 ? 


lOOOkm.s May 3, 2014 

Hi i had troubles pointing the domain to i'ts directory witch can be fixed by editing 

example.com. conf 

before: 

after: 

Now is working but i'm not sure that this is right solution. 

lOOOkm.s May 3, 2014 
Sorry "which" not "witch ". 

0 ? 


aveeshkumar May 7, 2014 
I also had to specify 

Require all granted 


https://www.digitalocean.com/community/tutorials/how-to-set-up-apache-virtual-hosts-on-ubuntu-14-04-lts 


15/20 



2/17/2016 


How To Set Up Apache Virtual Hosts on Ubuntu 14.04 LTS | DigitalOcean 


in the conf file as per 

http://httpd.apache.Org/docs/2.4/upgrading.html 


aveeshkumar May 7, 2014 

Posting comment filtered out the tags for 

It tag directory /var/www/test.com/public_html/ gt tag 

Require all granted 

It tag /directory gt tag 

in the conf file as per 

http://httpd.apache.Org/docs/2.4/upgrading.html 

0 ? 


roosterx813 May 8, 2014 

It worked for me, by doing this tutorial i learned about config files, command line, and got a 

website! Thank-you, 

roosterscomputerrepair.with-linux.com 

r2d2t2 May 20, 2014 

This works for me for 12.04 just by creating 000-default.conf instead of default default.conf. 

Now I am looking for how to incorporate secure (https) website as I have startssl.com 
certificate and key. 

Thanks for WONDERFUL work D.O. 

0 ? 


mulyana2205 May 22, 2014 

i got stuck in sudo a2ensite example.com.conf 
my terminal said "Site example.com does not exist" 
i miss something, or this tutorial not working in ubuntu 14.10? 

0 ? 


joshlsullivan February 28, 2015 

The conf must be missing from Apache. 

© 
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netominas September 11, 2015 

I'm with same errror, where this setting? 

O 

sanik August 24, 2015 

happened to me too but then I skipped to edit my hosts file and everything works fine 

netominas September 11, 2015 

I'm with same errror, where this setting? 

O 

sanik September 12, 2015 
I got an error when command this 

a2ensite example.com.conf 

instead I proceed to edit my host file 

/etc/hosts 

0 ? 

kamaln7 September 12, 2015 

Hi @netominas, does /etc/apache2/sites -available/sitename . conf exist? 

0 ? 

sanik September 13, 2015 

yes, you need to create that conf file for each of your domain, then add your domain to 
the hosts file 

O 

netominas September 17, 2015 

ow worked, I was creating the file sitenam without de ".conf". Tks! :) 

O 

asb May 22, 2014 

@mulyana2205: Does the file " /etc/apache2/sites -available/example . com . conf " 
actually exist? When you run " sudo a2ensite " make sure you use the name of the actual 
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file you created. 

0 ? 


kasnca May 27, 2014 

You don't have permission to access / on this server. 

kamaln7 May 28, 2014 

@kasnca: Do you have an index file in your documentroot? 

0 ? 


fabian.socarras June 7, 2014 

@kasnca: I was getting the same. Try adding: 


Require all granted 


It worked for me. 

0 ? 


isahappyperson June 8, 2014 

i copied the /etc/apache2/sites-available/000-default.conf 

over to /etc/apache2/sites-available/ididntsee.com.conf and edit it from there but am still 
getting the default apache 2 page instead of the index.html page 

I created two virtual host using two domain names I own and want to host on one droplet. 
The IP for one is still propagating but the first one is set and shows the default apache2 
page. 

0 ? 


isahappyperson June 8, 2014 

Scratch the first comment. I started over from scratch, new server with new ip - directed 
both domain names to new IP, followed all directions including new non-root user and now 
all I am getting is 404 not found error on one site and "could not connect to 
isahappyperson.com" error on the other. 

I took each step slowly as to not make any mistakes so I have no clue what to do now. 
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Does anyone know what is wrong? 

droplet server is on Ubuntu 14.04 LTS 

0 ? 


isahappyperson June 8, 2014 
update: 

I directed the domain names to the new IP in the DO dashboard but failed to change them 
where I registered the domain names. 

So, now one site works fine - is showing the custom index.html 
but the other site is showing the apache2 default index.html 

Any thoughts? 

0 ? 


cbunting99 October 14, 2014 

http://www.unixmen.com/setup-virtual-hosts-apache-ubuntu-14-04-lts/ 

DO is nothing but copy and paste tutorials.. I don't think half of the writers ever try these 
themselves.. 
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